package com.smartsystem.modules.system.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.smartsystem.modules.system.dto.SysUserDTO;
import com.smartsystem.modules.system.dto.SysUserQueryDTO;
import com.smartsystem.modules.system.entity.SysUser;
import com.smartsystem.modules.system.vo.SysUserVO;

import java.util.List;

/**
 * 用户表Service接口
 */
public interface SysUserService extends IService<SysUser> {
    
    /**
     * 根据用户名查询用户信息
     * @param username 用户名
     * @return 用户信息
     */
    SysUser findByUsername(String username);
    
    /**
     * 获取用户角色列表
     * @param userId 用户ID
     * @return 角色ID列表
     */
    List<Long> getUserRoles(Long userId);
    
    /**
     * 更新用户角色
     * @param userId 用户ID
     * @param roleIds 角色ID列表
     */
    void updateUserRoles(Long userId, List<Long> roleIds);
    
    /**
     * 验证用户密码
     * @param username 用户名
     * @param password 密码
     * @return 用户信息
     */
    SysUser validateUser(String username, String password);
    
    /**
     * 分页查询用户列表
     * @param queryDTO 查询条件
     * @return 用户分页数据
     */
    IPage<SysUserVO> getUserPage(SysUserQueryDTO queryDTO);
    
    /**
     * 根据ID获取用户详情
     * @param id 用户ID
     * @return 用户详情
     */
    SysUserVO getUserById(Long id);
    
    /**
     * 创建用户
     * @param userDTO 用户信息
     * @return 用户ID
     */
    Long createUser(SysUserDTO userDTO);
    
    /**
     * 更新用户
     * @param userDTO 用户信息
     * @return 是否成功
     */
    Boolean updateUser(SysUserDTO userDTO);
    
    /**
     * 删除用户
     * @param id 用户ID
     * @return 是否成功
     */
    Boolean deleteUser(Long id);
    
    /**
     * 批量删除用户
     * @param ids 用户ID列表
     * @return 是否成功
     */
    Boolean deleteUsers(List<Long> ids);
    
    /**
     * 重置用户密码
     * @param id 用户ID
     * @param newPassword 新密码
     * @return 是否成功
     */
    Boolean resetPassword(Long id, String newPassword);
    
    /**
     * 修改用户状态
     * @param id 用户ID
     * @param status 状态
     * @return 是否成功
     */
    Boolean updateStatus(Long id, Integer status);
    
    /**
     * 检查用户名是否存在
     * @param username 用户名
     * @param excludeId 排除的用户ID（用于修改时检查）
     * @return 是否存在
     */
    Boolean checkUsernameExists(String username, Long excludeId);
    
    /**
     * 检查手机号是否存在
     * @param phone 手机号
     * @param excludeId 排除的用户ID（用于修改时检查）
     * @return 是否存在
     */
    Boolean checkPhoneExists(String phone, Long excludeId);
    
    /**
     * 检查邮箱是否存在
     * @param email 邮箱
     * @param excludeId 排除的用户ID（用于修改时检查）
     * @return 是否存在
     */
    Boolean checkEmailExists(String email, Long excludeId);
}